home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / jget.man < prev    next >
Text File  |  1992-08-28  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. jget                      User Commands                      jget
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      jget - list contents of a Jaquith archive directory.
  12.  
  13. SSYYNNOOPPSSIISS
  14.      jjggeett   [--aarrcchh  _a_r_c_h_i_v_e]  [--sseerrvveerr  _h_o_s_t_n_a_m_e]   [--ppoorrtt  _p_o_r_t]
  15.      [--rraannggee  ((_d_a_t_e_1,_d_a_t_e_2)]  [--oowwnneerr  _n_a_m_e]  [--ggrroouupp _n_a_m_e] [--aabbss
  16.      _r_e_g_e_x_p] [--uu]] [[--aassooff _d_a_t_e] [--ssiinnccee _d_a_t_e] [--ffiirrsstt _n] [--llaasstt _n]
  17.      [--aallll]   [--mmooddddaattee]  [_f_i_l_e_l_i_s_t]  [--mmaaiill  _m_a_i_l_a_d_d_r]  [--ttaarrggeett
  18.      _d_i_r_e_c_t_o_r_y] [--ddiirr] [--ffiilltteerr]] [[--ttaarr] [--ttaarrbbuuff _b_u_f_S_i_z_e]
  19.  
  20.  
  21. OOPPTTIIOONNSS
  22.      --aarrcchh _a_r_c_h_i_v_e Name of logical archive.  If  none  is  speci-
  23.                    fied,  the  environment  variable  JARCHIVE is
  24.                    used, if defined, else the default archive  is
  25.                    used.
  26.  
  27.      --sseerrvveerr _h_o_s_t_n_a_m_e
  28.                    Specifies host where Jaquith  server  is  run-
  29.                    ning.  Defaults  to  the  environment variable
  30.                    JSERVER.
  31.  
  32.      --ppoorrtt _p_o_r_t    Specifies port number where Jaquith server  is
  33.                    running.  Defaults to the environment variable
  34.                    JPORT.
  35.  
  36.      --rraannggee _d_a_t_e_1,_d_a_t_e_2
  37.                    Retrieve files with date in specified range.
  38.  
  39.      --oowwnneerr _n_a_m_e   Retrieve only files with specified owner name.
  40.  
  41.      --ggrroouupp _n_a_m_e   Retrieve only files with specified group name.
  42.  
  43.      --aabbss _r_e_g_e_x_p   Retrieve files which  match  _r_e_g_e_x_p  in  their
  44.                    abstract lines.
  45.  
  46.      --aassooff _d_a_t_e    Retrieve  version  which  was  current  as  of
  47.                    specified  date.  Equivalent to: -range(1-jan-
  48.                    1970,_d_a_t_e)
  49.  
  50.      --ssiinnccee _d_a_t_e   Retrieve versions  between  _d_a_t_e  and  present
  51.                    date. Equivalent to: -range(_d_a_t_e,_p_r_e_s_e_n_t-_d_a_t_e)
  52.  
  53.      --ffiirrsstt _n      Retrieve from the  nth  version  in  the  date
  54.                    range.
  55.  
  56.      --llaasstt         Retrieve to the nth version in the date range.
  57.  
  58.      --aallll          Retrieve all  the  versions  in  the  archive.
  59.                    Equivalent to: -first 1 -last -1
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jget                      User Commands                      jget
  71.  
  72.  
  73.  
  74.      --mmooddddaattee      Use the  file's  modification  date,  not  its
  75.                    archive date for all date comparisons.
  76.  
  77.      --mmaaiill         Send response by mail to _m_a_i_l_a_d_d_r.
  78.  
  79.      --ttaarrggeett _d_i_r_e_c_t_o_r_y
  80.                    Restore file hierarchy relative  to  specified
  81.                    directory.   By  default,  files  are restored
  82.                    with their original pathnames.
  83.  
  84.      --ddiirr          Restore directory's top-level contents only.
  85.  
  86.      --ffiilltteerr       Run jget as in filter mode. Data  is  restored
  87.                    directly to stdout.
  88.  
  89.      --ttaarr          Data is restored directly  to  stdout  in  tar
  90.                    format.
  91.  
  92.      --ttaarrbbuuff _b_u_f_S_i_z_e
  93.                    With --ttaarr option, use a buffer  size  of  _b_u_f_-
  94.                    _S_i_z_e.  Default is 10KB.
  95. _________________________________________________________________
  96.  
  97. DDEESSCCRRIIPPTTIIOONN
  98.      JJggeett provides a  simple  file  retrieval  mechanism  for  an
  99.      archive tape system controlled by the Jaquith program.
  100.  
  101.      The primary argument _f_i_l_e_l_i_s_t is a   file  expression  which
  102.      specifies  the  files  to be listed.  Shell-like globbing is
  103.      supported. '*' matches any number of characters. '?' matches
  104.      a  single  character. Additionally, curly braces can be used
  105.      to enclose alternatives.  For  example  foo.{bak,?}  matches
  106.      both foo.bak, foo.c and foo.h.
  107.  
  108.      Note that any metacharacters which are not protected with  a
  109.      backslash  or  quotes  will be expanded by the shell, not by
  110.      the Jaquith system.
  111.  
  112.      The default action is to retrieve the most  recent  versions
  113.      of  matching  filenames.   The set of files retrieved can be
  114.      controlled by the use of one or more options.   The  options
  115.      are  all  logically  ANDed together; only files matching all
  116.      criteria are retrieved.
  117.  
  118.      The -range,  -first  and  -last  options  work  together  to
  119.      specify  a subset of the archived versions.  First, the date
  120.      range is applied, resulting in a list of candidates numbered
  121.      logically  from 1 to _n.  Then the first and last options are
  122.      applied to this list. First and last  can  be  positive  and
  123.      retrieve  the  specified  filenames from restricted list, or
  124.      they can be negative in which case they count from  the  end
  125.      of  the list. Thus, the most recent version of a file can be
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. jget                      User Commands                      jget
  137.  
  138.  
  139.  
  140.      retrieved with 'first -1 last -1' without having to know how
  141.      many versions currently exist.
  142.  
  143.      _d_a_t_e is of the form _D_a_t_e_S_p_e_c[:_T_i_m_e_S_p_e_c]. _T_i_m_e_S_p_e_c is of  the
  144.      form   [hh[:mm[:ss]]],   and   _D_a_t_e_S_p_e_c   is   of  the  form
  145.      dd-month[-yyyy]. Month is the first 3 letters of the  month;
  146.      all  others  are  numbers. The '/' character is a substitute
  147.      for '-' and '.' may be used instead of ':'.
  148.  
  149.  
  150. BBUUGGSS
  151.      A file which matches more than one regular  expression  will
  152.      be retrieved multiple times.
  153.  
  154.      There is currently no support for hard links.
  155.  
  156.      Only one archive can be specified at a time.
  157.  
  158.      Unlike the shell, the Jaquith globbing  characters  '*'  and
  159.      '?' match a '.' in the first position.
  160.  
  161.  
  162. SSEEEE AALLSSOO
  163.      jaquith jmgr jls jstat jput jctrl jcopy jclean jbuild
  164.  
  165.  
  166. KKEEYYWWOORRDDSS
  167.      jaquith archive
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.